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Foreword 



rd , 



The present document has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



£75/ 



3GPP TS 26.268 version 8.0.0 Release 8 5 ETSI TS 1 26 268 V8.0.0 (2009-04) 



Scope 



The present document contains an electronic copy of the ANSI-C code for the eCall in-band modem solution for 
reliable transmission of MSD data from IVS to PSAP via the speech channel of cellular networks. The ANSI-C code is 
necessary for a bit exact implementation of the IVS modem and PSAP modem described in 3GPP TS 26.267 [1]. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 26.267: "eCall Data Transfer; In-band modem solution; General description". 

See also the references in 3GPP TS 26.267 [1]. 



3 Abbreviations 

For the purpose of the present document, the following abbreviations apply: 

ACK ACKnowledgement 

ANSI American National Standards Institute 

CRC Cyclic Redundancy Check 

FEC Forward Error Correction 

GSM Global System for Mobile communications 

HARQ Hybrid Automatic Repeat-reQuest 

I/O Input/Output 

IVS In-Vehicle System 

MSD Minimum Set of Data 

NACK Negative ACKnowledgement 

PCM Pulse Code Modulation 

PSAP Public Safety Answering Point 

RAM Random Access Memory 

ROM Read Only Memory 

RX Receive 

TX Transmit 



4 C code structure 

This clause gives an overview of the structure of the bit-exact C code and provides an overview of the contents and 
organization of the C code attached to the present document. 

The C code has been verified on the following systems: 

• Windows XP SP2 and Microsoft Visual Studio V8.0; 

• Linux (Suse Linux) using the gcc v3.4.2 and v4.L2 compilers. 
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4.1 



Contents of the C source code 



The distributed files with suffix "c" contain the source code and the files with suffix "h" are the header files. 
Further explanation on the files is given in the readme . txt file, which is reproduced in part here: 

Package Contents 



folder ' ecall ' : 

Contains the complete eCall ANSI C fixed-point reference source code. 

modem_ivs . c : top-level modem implementation for IVS 
modem_psap.c : top-level modem implementation for PSAP 

modemx.h : header file for both modem_ivs . c and modem_psap . c 

ecall_def ines .h : compile time options and preprocessor constants 



ecall_f ec .h 
ecall_modem.h 
ecall_sync .h 
ecall rom.h 



header file FEC encoder and decoder 
header file modulator and demodulator 
header file synchronization 
header file ROM data 



ecall_f ec . c 
ecall_modem. c 
ecall_sync . c 
ecall rom.c 



FEC encoder and decoder 
modulator and demodulator 
synchronization 
ROM data 



folder 'pcm' : 

Contains PCM data files for offline testing of the eCall IVS and PSAP 
modems, with the standalone wrapper invoking the interface functions. 
The PCM format is 16 bit signed, little endian, at 8 kHz sampling rate. 
The data files reflect 26 test cases and were generated from the eCall 
simulation framework. 

campaign_short.txt : configuration file for the 26 test cases 

pcmdlout<index> .pcm : output PCM data of DL vocoder = input to IVS 
pcmulout<index> .pcm : output PCM data of UL vocoder = input to PSAP 

pcmdlin<index> .pcm : test vectors for PSAP modem output 
pcmulin<index> .pcm : test vectors for IVS modem output 

folder ' TEST_SETUP ' : 

Contains a test setup for an eCall transmission. 

standalone . c 

main ( ) wrapper to run the IVS or PSAP modem on prestored PCM data 

standalone .h 

header file for standalone. c 



Makefile .win 

Microsoft Visual Studio 2005/2008 Makefile 

Builds 'standalone.exe' from standalone. c and the eCall sources, 

build options are RELEASE and DEBUG. 



Makefile .glx 

GNU Linux Makefile using gcc 

Builds 'standalone' from standalone. c and the eCall sources, 

build options are RELEASE and DEBUG. 

verify.bat 

Windows batch file 
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Runs 'standalone.exe' in mode ' -m ivs ' and ' -m psap ' on 26 test cases 
(folder 'pern') and performs a test vector comparison to the respective 
modem output PCM data. 

verify. sh 

Linux shell script 

Runs 'standalone' in mode ' -m ivs' and ' -m psap' on 26 test cases 
(folder 'pcm') and performs a test vector comparison to the respective 
modem output PCM data . 



4.2 Program execution 

An explanation on code compilation and execution is given in the readme . txt file, which is reproduced in part here: 

Getting Started 



3GPP TS 26.268 provides the eCall modem source code and a standalone wrapper 
which allows to run either the IVS or PSAP modem on prestored PCM data. Five 
functions represent the eCall modem interface: 

* PsapSendStart 

* PsapReset 

* PsapProcess 

* IvsReset 

* IvsProcess 

The external application must in addition implement the callback function 
PsapReceiveMsd, which the PSAP modem will call once the MSD was successfully 
received. See standalone. c for an example. 

For a real-time simulation over 3GPP FR and AMR vocoders and to log PCM data 

as input to the standalone wrapper, the eCall sources have to be integrated 

into a simulation framework (test setup) ; the one used in the 3GPP selection tests is 

attached in the subf older TEST_SETUP . The basic integration steps are briefly described 

below. 

In order to compile and run the eCall modem code, follow the instructions 
given below. For code testing, two batch files have been provided: 

* verify.bat : MS Windows systems 

* verify. sh : Linux systems 

They run the standalone wrapper in both IVS and PSAP mode on PCM data files 
that belong to the 26 test cases of campaign_short.txt (TEST_SETUP) . In PSAP 
mode, you should see the message 'MSD received! ' on completion of each test 
case. The output PCM files in folder 'out' are finally compared to the test 
vectors in folder 'pcm'. 

Code Compilation 



MS Windows systems 

To build standalone.exe from standalone. c and the eCall sources, start 
with opening a new project in Visual Studio 2005/2008. 

Choose File -> New -> 'Project from Existing Code' and follow the 
instructions of the 'Create Project from Existing Code Files Wizard'. 
Configuration : 

* Type of project: Visual C++ 

* Specify the folder location of standalone. c and a project name 

* Button 'Next' 

* Select 'Use external build system' 
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* For Debug and Release configuration, specify 

Build command line: nmake -f Makefile .win 
Clean command line: nmake -f Makefile .win clean 

Build the project with shorthand key ' F7 ' or from the menu. 

The source code should compile without any errors or warnings. 

Run 'verify.bat' to verify the executable against the test vectors. 



GNU Linux systems 

Compilation under Linux has been tested with 

* GNU Make version 3.81 

* gcc version 4.1.3 and 4.2.4 

For building the executable 'standalone' and cleanup, use 

make -f Makefile. glx 

make -f Makefile. glx clean 

On the platforms tested, the code compiled without errors or warnings. 
Run ' verify. sh' to verify the executable against the test vectors. 



Simulation Framework 



See LICENSE.TXT and README.TXT in folder TEST_SETUP for terms of usage! 

Note that this simulation framework has to be compiled and run on MS Windows 
operating systems, as Windows specific API functions are used and the FR and 
AMR vocoders are attached to the framework in form of Windows executables . 

To attach the eCall sources to the framework, copy the 'ecall' folder into 
the 'c' folder of directory TEST_SETUP . Compile and link the *.c files under 
subf older 'ecall' by adding their corresponding object files to the list of 
makefile targets. Note that modem_ivs . c and modem_psap.c replace the code 
template modem_demo . c . 



4.3 



Variables, constants and tables 



4.3.1 Description of constants used in the C-code 

This clause contains a listing of all global constants defined in ecall_def ines . h., together with some explanatory 
comments. 



Constant 



Value 



Description 



#define MAX(a,b) 
#define MIN(a,b) 
#define ABS (a) 
#define SIGN (a) 



((a)>(b) ? (a) : (b) 

((a)<(b) ? (a) : (b) 

( (a)<0 ? (-a) : (a)) 

( (a)<0 ? (-1) : (D) 



#define PCM_LENGTH 
#define MSD MAX LENGTH 



160 
140 



length of PCM frame 

length of MSD message (bytes) 



/* Synchronization */ 
#define SYNC_EVENTS 
#define SYNC_BADCHECKS 
#define SYNC_IDXLEN 
#define SYNC THRESHOLD 



(3) 
(8) 

(75) 
(10e6) 



sync events required at IVS 
IVS subsequent bad checks 
sync index length 
sync threshold 



ttdefine LOCK_START 
#define FAIL RESTART 



(3) 
(3) 



number of START to lock sync 
number of START messages to restart 
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#define NRF_WAKEUP 
#define NRF_SYNC 
#define NRF SYNCOBSV 



(3) 

(13) 

(10) 



number of wakeup frames 

length of sync in frames 

number of frames the PSAP checks for a 

better sync after detecting a preamble 



#define PNSEQ_OSF 
ttdefine PEAK_DIST_PP 
#define PEAK_DIST_NN 
#define PEAK DIST PN 



(22) "oversampling" rate of PN sequence 

(30*PNSEQ_OSF) distance outer positive peaks 

(54*PNSEQ_0SF) distance negative peaks 

(12*PNSEQ_0SF) distance positive to negative 



/* Uplink/Downlink format */ 
#define ARQ_MAX 
#define NRB_TAIL 
#define NRB CRC 



(3) 
(28) 



number of redundancy versions 
number of encoder tail bits 
order of CRC polynomial 



#define NRB_INFO 
#define NRB_INFO_CRC 
#define NRB_CODE_ARQ 
#define NRB CODE BUFFER 



( 8 *iyiSD_MAX_LENGTH) 

(8*MSD_MAX_LENGTH + NRB_CRC) 

(1380) 

(3*(8*MSD MAX LENGTH + NRB CRC) 



4*NRB TAIL) 



#define NRF_DLDATA 
ttdefine NRF_DLMUTE1 
ttdefine NRF_DLMUTE2 
#define NRF DLCHUNK 



(3) DL data part 

(2) DL 1st muting (after sync) 

(2) DL 2nd muting (after data) 

(NRF SYNC + NRF DLMUTEl + NRF DLDATA + NRF DLMUTE2 ) 



/* IVS/PSAP processing */ 
#define NRF_MEMIVS 
#define NRF_MEMPSAP 
#define NRS MEMSYNC 



(5) 
(2) 
(820) 



buffer size in frames (IVS) 
buffer size in frames (PSAP) 
memory size in samples (SYNC) 



#define IVS_THRESHOLD 
#define IVS_GOSTART 
#define IVS_TXFAST 
#define IVS TXINC 



(40000) 
(6) 
(10) 
(87) 



threshold feedback messages 
threshold for unreliable START 
fast modulator mode NACK condition 
sample increment at restart 



#define FEC_VAR 
#define FEC_MEAN 
#define FEC_ITERATIONS 
#define FEC STATES 



(30206) variance: 1/4550000 in Q37 

(0xB9999A) mean: 5.8 in Q21 

(8) number of decoder iterations 

(8) number of decoder states 



#define IntLLR Intl6 

#define LLR_MAX ((Int32) 

#define LOGEXP_RES (401) 

#define LOGEXP_DELTA (-6) 

#define LOGEXP_QIN (8) 

4.3.2 Type Definitions 



size of soft bit buffer variables 
(Ox7fff-l) ) 

resolution of LOGEXP table 
determines internal Q-factor 
input Q-factor of LLR values 



The following type definitions have been used, which are defined in ecall_defines.h, ecall_modem.h, ecall_sync.h, and 
modemx.h: 



Definition 



Description 



typedef signed char Int8; 
typedef signed short int Intl6; 
typedef signed int Int32; 



8 bit signed variable 
16 bit signed variable 
32 bit signed variable 



typedef unsigned char Ordl; 

typedef unsigned char Ord8 ; 

typedef unsigned short int Ordl6; 

typedef unsigned int Ord32; 



binary symbol 
8 bit unsigned variable 
16 bit unsigned variable 
32 bit unsigned variable 



typedef enum { 
Mod3bit4smp, 
Mod3bit8smp 

} ModType; 



modulator type for uplink transmission 



typedef struct 
Int 16 bpsym; 
Int 16 spmf; 



bits per symbol 

samples per modulation frame 
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Intl6 mfpf; 

Intl6 decposl; 

Intl6 decpos2 ; 

Intl6 wutperiod; 

Intl6 nfmutel; 

Intl6 nf mute4 ; 

Intl6 nfmuteall; 

Intl6 nfdata; 



modulation frames per frame = PCM_LENGTH/spmf 

position 1st decoding trial 

position 2nd decoding trial 

wakeup tone period in samples 

number of muting frames 1st interval 

number of muting frames 4th interval 

number of muting frames total 

number of data frames = NRB_CODE_ARQ/ (mfpf *bpsym) 



const Intl6 *ulPulse; 

const Intl6 *ulPulseMatch; 

const Intl6 *mgTable; 

const Intl6 *wakeupSin; 

const Intl6 *wakeupCos; 
} ModState; 



modulator state for uplink transmission 



typedef struct { 
Int32 *state; 
Int3 2 *wakeupState; 



memory for wakeup tone detector 



Int32 amplitude [3] 

Intl6 corrIndex[4] 

Int32 checkMem[4] ; 

Intl6 peakPos [4] ; 



amplitudes (average, maximum, memory) 
position of sync check 

correlation value memory of sync check 
position of sync peaks within feedback message 



Intl6 checkCounter ; 
Intl6 obsvCounter ; 
Intl6 msgCounter; 



counts subsequent sync check failures 
counts frames after successful sync 
counts feedback messages 



Intl6 index; 

Intl6 offset; 

Intl6 delay; 

Intl6 tempDelay; 

Intl6 prevDelay; 

Intl6 trials; 

Intl6 npeaks; 

Intl6 events; 



frame reference for sync evaluation 

frame offset 

synchronization delay (position) 

temporary delay in two-stage peak evaluation 

previous sync delay 

number of sync trials 

number of sync peaks detected 

number of subsequent equal sync events 



Ordl flag; 

Ordl checkOk; 
} SyncState; 
typedef enum { 

DlMsgStart, 

DlMsgNack, 

DlMsgAck, 

DlMsgldle 
} DlData; 



indicates successful sync 
indicates successful sync check 
state of synchronization functions 



downlink message identifiers 



typedef enum 
Ivsldle, 
IvsSendMsd 

} IvsState; 



IVS state identifiers 



typedef struct { 
ModState mod; 
SyncState sync; 



IVS modulator struct */ 
IVS sync struct */ 



Int32 syncBuffer [NRS_MEMSYNC] ; 
Intl6 delayBuffer [2*PCM_LENGTH] ; 
Intl6 pcmBuffer [NRF_MEMIVS*PCM_LENGTH] ; 
Ordl bitBuf f er [NRB CODE BUFFER] ; 



Intl6 state; 

Intl6 stateCnt [4] ; 

Intl6 startCntlgnore; 

Intl6 globalNackCnt; 



IVS state 

state counters 

counts unreliable START messages 

counts NACK messages 



Intl6 txN; 
Intl6 txindex; 
Intl6 txRedVer; 



TX number of frames 

TX frame counter 

TX redundancy version 
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Intl6 txDelay; 
Intl6 rxN; 
Intl6 rxindex; 
Intl6 rxRead; 
} IvsData; 

typedef enum { 

Psapldle, 

PsapStart , 

PsapNack, 

PsapAck, 

PsapTrigger, 

PsapStartToTrigger 
} PsapState; 

typedef struct { 
ModState mod; 
SyncState sync; 

OrdS *msd; 
Ordl *msdBin; 
Intl6 *pcmBuffer; 
IntLLR *bitBuffer; 



TX offset in samples 

RX number of frames 

RX frame counter 

RX sync indication 

struct that gathers parameters relevant at IVS 



char buffer [0 

+ sizeof (IntLLR) * NRB_CODE_ARQ 

+ sizeof (Intl6) * NRF_MEMPSAP*PCM_LENGTH 

+ sizeof (Int32) * NRS_MEMSYNC 

+ sizeof (Int32) * 2* (NRF SYNC+1)]; 



PSAP state identifiers 



PSAP modulator struct 
PSAP sync struct 

MSD in byte representation 
MSD in binary representation 
sync buffer 
soft bit buffer for decoding 

general purpose buffer 



Intl6 state; 

Intl6 dlData; 

Intl6 txN; 

Intl6 txindex; 

Intl6 mglndex; 

Intl6 rxN; 

Intl6 rxindex; 

Intl6 rxRedVer; 

Intl6 rxDecTrials; 
PsapData; 



PSAP state 

downlink message symbol 

TX number of frames 

TX frame counter 

RX current position in muting gap table 

RX number of frames (without muting) 

RX frame counter 

RX redundancy version 

RX decoding trails 

struct that gathers parameters relevant at PSAP 



4.3.3 Description of fixed tables used in tine C-code 

This clause contains a listing of all fixed tables (ROM) defined in ecall_rom . c. 

Type/Constant Dimension Description 

/* Synchronization */ 
Intl6 wakeupSinSOO 
Intl6 wakeupCosSOO 
Intl6 wakeupSinSOO 
Intl6 wakeupCosSOO 



Intl6 syncPulseForm 

Intl6 syncSequence 

Intl6 syncIndexPreamble 

Intl6 syncFrame 

/* Uplink/Downlink format */ 
Intl6 indexBits 

// fast modulator mode: 
Intl6 m4smp_ul Pulse 
Intl6 m4smp_ulPulseMatch 
Intl6 m4smp_mgTable 

// robust modulator mode: 
Intl6 mSsmp_ul Pulse 
Intl6 mSsmp_ulPulseMatch 



[16] 




[16] 




[10] 




[10] 




[5] 




[15] 




[SYNC 


IDXLEN] 


[1600] 





[24] 



[16] 
[64] 
[54] 



[32] 
[12? 



sine waveform at 500 Hz 
cosine waveform at 500 Hz 
sine waveform at 800 Hz 
cosine waveform at 800 Hz 

sync pulse 

sync pulse sequence 

sync pulse positions 

predefined synchronization signal 



bit positions for turbo decoder 



uplink waveform 

matched filtered uplink waveform 

table indicating muting gaps 



uplink waveform 

matched filtered uplink waveform 
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Intl6 m8smp_mgTable 

Intl6 dlPcmData 
Intl6 dlPcmDataMatch 

/* FEC encoder/decoder */ 
Ordl6 stateTransMat 
Ordl6 stateTrans 
Ordl6 revStateTransMat 
Ordl6 revStateTrans 
Ordl outputParityMat 
Ordl outputParity 

Ordl crcPolynomial 
Ordl scramblingSeq 
Ordl6 interleaverSeq 
Ordl6 redVerlndex 

IntLLR logExpTable 



[104] 



table indicating muting gaps 



[4] [NRF_DLDATA*PCM_LENGTH] downlink transmit signal 
[4] [NRF_DLDATA*PCM_LENGTH] DL MF signal 



[8] [2] 
[16] 
[8] [2] 
[16] 
[8] [2] 
[16] 

[NRB_CRC+1] 
[NRB_INFO_CRC] 
[NRB_INFO_CRC] 
[8] [NRB_CODE_ARQ] 

[LOGEXP RES] 



FEC 
FEC 
FEC 
FEC 
FEC 
FEC 



State transitions 
state transitions 
reverse state transitions 
reverse state transitions 
output parity indicator 
output parity indicator 



coefficients of CRC polynomial 
bit scrambling sequence 
interleaver sequence 
index vector for HARQ process 

lookup table (logExp function) 



4.3.4 Static variables used in tine C-code 



This clause contains a listing of static variables (RAM) defined in source files. 
Definition Description 



IvsData ivs 

PsapData psap 

WordLLR chCodedSoftBitBuffer [NRB CODE BUFFER] 



IVS static memory 

PSAP static memory 

soft bit buffer of turbo decoder 



4.4 



Functions of the C Code 



This clause contains the headers of the employed IVS and PSAP functions. They correspond to a large extent to the 
functional description of the IVS and PSAP provided in 3GPP TS 26.267 [1]. 

Figure 1 gives an overview of the most important functions and their hierarchical relation. 
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IvsReset 



Byte2Bit 



FecEncode ( ) 






AttachCRCO 












Scramble ( ) 














EncodeTwo ( ) 








EncodeOne ( ) 

















PsapSendStart 



PsapReset 



IvsProcess () 






IvsProcessSync ( ) 

- EcallSyncO 

- EcallSyncCheck 












IvsProcessState () 

- IvsReceiver 

- SetModStateO 












IvsTransmitter ( ) 








SymbolMod ( ) 

















PsapProcessO 





PsapProcessState ( ) 






- EcallSyncO 

- SetModStateO 
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4.4.1 Interface functions 

I* IVS implementation: IvsReset */ 

/* */ 

/* Description: Reset of IVS before the reception of a new MSD */ 

/* */ 

/* In: const OrdS* msd -> MSD to be transmitted */ 

/* int length -> MSD length (equal to MSD_MAX_LENGTH) */ 

/* */ 

void IvsReset (const OrdS *msd, int length) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* IVS implementation: IvsProcess */ 

/* */ 

/* Description: IVS modem function that processes the PCM data */ 

/* */ 

/* InOut : Intl6* pcm <-> input and output frame of 16bit PCM samples */ 

/* */ 

void IvsProcess (Intl6 *pcm) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* PSAP implementation: PsapSendStart */ 

/* */ 

/* Description: Initiates PSAP to trigger the transmission of an MSD */ 

/* */ 

void PsapSendStart ( ) 

/*============================================================================*! 

/* PSAP implementation: PsapReset */ 

/* */ 

/* Description: Reset of PSAP before the reception of a new MSD */ 

/* */ 

void PsapReset 

/*============================================================================*/ 

/* PSAP implementation: PsapProcess */ 

/* */ 

/* Description: PSAP modem function that processes the PCM data */ 

/* */ 

/* InOut : Intl6* pcm <-> input and output frame of 16bit PCM samples */ 
/* */ 

void PsapProcess (Intl6 *pcm) 

4.4.2 IVS transmitter functions 

/* IVS FUNCTION: IvsTransmitter */ 

/* */ 

/* Description: IVS transmitter function */ 

/* */ 

/* In: const ModState* ms -> modulator struct */ 

/* const Ordl* buffer -> code bit buffer */ 

/* Intl5 rv -> redundancy version */ 

/* Intl6 index -> position within uplink frame */ 

/* Out: Intl6* pcm <- output data */ 

/* */ 

void IvsTransmitter (const ModState *ms, const Ordl *buffer, Intl6 *pcm, 

Intl6 rv, Intl6 index) 
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/*============================================================================*/ 

/* IVS FUNCTION: SymbolMod */ 

/* */ 

/* Description: symbol modulator */ 

/* */ 

/* In: const ModState* ms -> modulator struct */ 

/* Intl6 symbol -> symbol index */ 

/* Out: Intl6* mPulse <- modulated output sequence */ 

/* */ 

void SymbolMod (const ModState *ms, Intl6 symbol, Intl6 *mPulse) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* IVS FUNCTION: Byte2Bit */ 

/* */ 

/* Description: conversion byte vector to bit vector */ 

/* */ 

/* In: Ord8* in -> vector of input bytes */ 

/* Intl5 length -> length of input */ 

/* Out: Ordl* out <- vector of output bits */ 

/* */ 

void Byte2Bit (const OrdS *in, Ordl *out, Intl6 length) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

I* ENCODER FUNCTION: FecEncode */ 

/* */ 

/* Description: encoding of MSD */ 

/* */ 

/* InOut : Ordl *buffer <-> takes info bits and returns coded bits */ 

/* */ 

void FecEncode (Ordl *buf f er) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* ENCODER FUNCTION: AttachCrc */ 

/* */ 

/* Description: attaches CRC bits */ 

/* */ 

/* In: const Ordl* infoBits -> input information bits */ 

/* Out: Ordl* infoWithCrc <- bits with CRC attached */ 

/* */ 

void AttachCrc (const Ordl *infoBits, Ordl *inf oWithCrc) 
/*============================================================================*! 

I* ENCODER FUNCTION: Scramble */ 

/* */ 

/* Description: bit scrambling */ 

/* */ 

/* In: const Ordl* in -> non scrambled input bit sequence */ 

/* Out: Ordl* out <- scrambled output bit sequence */ 

/* */ 

void Scramble (const Ordl *in, Ordl *out) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* ENCODER FUNCTION: EncodeTwo */ 

/* */ 

/* Description: encoding of bit sequence */ 

/* */ 

/* InOut : Ordl* codedBits <-> scrambled bits to coded bits */ 

/* */ 

void EncodeTwo (Ordl *codedBits) 
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/*============================================================================*/ 

/* ENCODER FUNCTION: EncodeOne */ 

/* */ 

/* Description: convolutional encoding of each component */ 

/* */ 

/* In: Intl6 encNr -> component number */ 

/* InOut : Ordl* codedBits <-> bits to be encoded */ 

/* */ 

void EncodeOne (Ordl *codedBits, Intl6 encNr) 

4.4.3 PSAP receiver functions 

/* UTILITY FUNCTION: PsapProcessState */ 

/* */ 

/* Description: PSAP state machine, determines PSAP receiver operation */ 

/* according to the state */ 

/* */ 

/* In: const Intl6* pcm -> input frame of 16bit PCM samples */ 

/* */ 

void PsapProcessState (const Intl6 *pcm) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* PSAP FUNCTION: PsapReceiver */ 

/* */ 

/* Description: PSAP receiver function (decoding is done outside) */ 

/* */ 

/* In: const ModState* ms -> modulator struct */ 

/* const Intl6* pcm -> input data for demodulation */ 

/* Out: IntLLR* softBits <- demodulated soft bit sequence */ 

/* */ 

void PsapReceiver (const ModState *ms, const Intl6 *pcm, IntLLR *softBits) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

I* PSAP FUNCTION: SymbolDemod */ 

/* */ 

/* Description: symbol demodulator */ 

/* */ 

/* In: const ModState* ms -> modulator struct */ 

/* const Intl6* mPulse -> received pulse train */ 

/* Out: IntLLR* softBits <- demodulated soft bit sequence */ 

/* */ 

void SymbolDemod (const ModState *ms, const Intl6 *mPulse, IntLLR *softBits) 
/*============================================================================*! 

/* PSAP FUNCTION: Bit2Byte */ 

/* */ 

/* Description: conversion bit vector to byte vector */ 

/* */ 

/* In: const Ordl* in -> vector of input bits */ 

/* Intl6 length -> length of output */ 

/* Out: OrdS* out <- vector of output bytes */ 

/* */ 

void Bit2Byte (const Ordl *in, OrdS *out, Intl6 length) 
/*============================================================================*! 

/* PSAP FUNCTION: MpyLacc */ 

/* */ 

/* Description: multiply 32bit number with 16bit number (32bit result) */ 

/* */ 

/* In: Int32 var32 -> 32bit number */ 

/* Intl6 varl6 -> 16bit number */ 

/* Return: Int32 <- result */ 

/* */ 

Int32 MpyLacc (Int32 var32, Intl6 varl6) 
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/*============================================================================*/ 

/* DECODER FUNCTION: FecDecode */ 

/* */ 

/* Description: decoding to find the MSD */ 

/* */ 

/* In: const IntLLR* in -> received soft bits */ 

/* Intl6 rv -> redundancy version */ 

/* Out: Ordl* out <- decoded MSD in binary representation */ 

/* Return: Ordl <- result of CRC check */ 

/* */ 

Ordl FecDecode (const IntLLR *in, Intl5 rv, Ordl *out) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* DECODER FUNCTION: UpdateBuffer */ 

/* */ 

/* Description: update channel LLR buffer with new soft bits */ 

/* */ 

/* In: const IntLLR* softlnBits -> received soft bits */ 

/* Intl6 rv -> redundancy version */ 

/* InOut : IntLLR* chLLRbuffer <-> decoder buffer */ 

/* */ 

void UpdateBuffer (IntLLR *chLLRbuf f er, const IntLLR *softInBits, Intl6 rv) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* DECODER FUNCTION: DecodeBuffer */ 

/* */ 

/* Description: decoding of LLR buffer */ 

/* */ 

/* In: const IntLLR* systl -> RX systematic soft bits */ 

/* const IntLLR* syst2 -> interleaved RX systematic tail bits */ 

/* const IntLLR* parityl -> RX parity soft bits */ 

/* const IntLLR* parity2 -> interleaved RX parity soft bits */ 

/* Out: Ordl* decBits <- decoded bits */ 

/* */ 

void DecodeBuffer (const IntLLR *systl, const IntLLR *syst2, 

const IntLLR *parityl, const IntLLR *parity2 , Ordl *decBits) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* DECODER FUNCTION: Bcjr */ 

/* */ 

/* Description: BCJR algorithm */ 

/* */ 

/* In: const IntLLR* parity -> received parity soft bits */ 

/* InOut : IntLLR* extrinsic <-> extrinsic information */ 

/* */ 

void Bcjr (const IntLLR *parity, IntLLR *extrinsic) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* DECODER FUNCTION: Interleave */ 

/* */ 

/* Description: Turbo code interleaver */ 

/* */ 

/* In: const IntLLR* in -> input sequence */ 

/* Out: IntLLR* out <- output sequence */ 

/* */ 

void Interleave (const IntLLR *in, IntLLR *out) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* DECODER FUNCTION: Deinterleave */ 

/* */ 

/* Description: Turbo code deinterleaver */ 

/* */ 

/* InOut: IntLLR* inout <-> input and deinterleaved output sequence */ 

/* */ 

void Deinterleave (IntLLR * inout) 
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/* DECODER FUNCTION: Descramble */ 

/* */ 

/* Description: descrambles decoded bits */ 

/* */ 

/* InOut : Ordl* inout <-> input and output bit sequence */ 

/* */ 

void Descramble (Ordl *inout) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* DECODER FUNCTION: DecodeCrc */ 

/* */ 

/* Description: check CRC of decoded bits */ 

/* */ 

/* In: const Ordl* codedBits -> decoded bit sequence to be checked */ 

/* Return: Ordl <- result of CRC check */ 

/* */ 

Ordl DecodeCrc (const Ordl *codedBits) 



/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* DECODER FUNCTION: GammaQ */ 

/* */ 

/* Description: compute gamma values for BCJR algorithm */ 

/* */ 

/* In: Intl6 k -> bit position */ 

/* Intl6 1 -> state */ 

/* const IntLLR* parity -> received parity bits */ 

/* const IntLLR* extrinsic -> sum of extrinsic and systematic bits */ 

/* Return: IntLLR <- value of gamma (k,l) */ 

/* */ 

IntLLR GammaQ(Intl6 k, Intl6 1, const IntLLR *parity, const IntLLR *extrinsic) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

I* UTILITY FUNCTION: JacLog */ 

/* */ 

/* Description: Jacobian logarithm */ 

/* */ 

/* In: IntLLR a -> value one */ 

/* IntLLR b -> value two */ 

/* Return: IntLLR <- Jacobian logarithm */ 

/* */ 

IntLLR JacLog (Int32 a, Int32 b) 



4.4.4 PSAP transmitter functions 

/* PSAP FUNCTION: PsapTransmitter */ 

/* */ 

/* Description: PSAP downlink transmitter (uses prestored sequences) */ 

/* */ 

/* In: Intl6 symbol -> one out of four downlink symbols */ 

/* Intl6 index -> position within downlink frame */ 

/* Out: Intl6* pcm <- output data */ 

/* */ 

void PsapTransmitter (Intl6 *pcm, Intl6 symbol, Intl6 index) 
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4.4.5 IVS receiver functions 

I* UTILITY FUNCTION: IvsProcessState */ 

/* */ 

/* Description: IVS state machine, evaluating feedback messages */ 

/* */ 

/* In: const Intl6* buffer -> pointer to PCM DL data buffer */ 

/* */ 

void IvsProcessState (const Intl6 *buf fer) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* IVS FUNCTION: IvsReceiver */ 

/* */ 

/* Description: IVS receiver function */ 

/* */ 

/* In: const Intl6* pom -> input to downlink receiver */ 

/* Out: Int32* metric <- metric [k] : k = 0..3 correlation values */ 

/* <- metric [4] : reliability factor (-1: skip) */ 

/* Return: Intl6 <- demodulated message */ 

/* */ 

Intl6 IvsReceiver (const Intl6 *pcm, Int32 *metric) 

4.4.6 Synclnronization functions (IVS and PSAP) 

I* FUNCTION: EcallSync */ 

/* */ 

/* Description: main synchronization function */ 

/* */ 

/* In: const Intl6* pom -> input frame */ 

/* const char* caller -> text to identify PSAP or IVS */ 

/* InOut : SyncState* sync <-> sync struct */ 

/* */ 

void EcallSync (SyncState *sync, const Intl6 *pcm, const char *caller) 
/*============================================================================*! 

/* UTILITY FUNCTION: IvsProcessSync */ 

/* */ 

/* Description: IVS sync evaluation */ 

/* */ 

/* In: const Intl6* pcm -> input frame of 16bit PCM samples */ 

/* */ 

void IvsProcessSync (const Intl6 *pcm) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* IVS FUNCTION: EcallSyncCheck */ 

/* */ 

/* Description: checks whether sync is still valid at IVS */ 

/* */ 

/* In: const Intl6* pcm -> input frame */ 

/* InOut : SyncState* sync <-> sync struct */ 

/* */ 

void EcallSyncCheck (SyncState *sync, const Intl5 *pcm) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* UTILITY FUNCTION: ToneDetect */ 

/* */ 

/* Description: tone detection at 500 Hz or 800 Hz */ 

/* */ 

/* In: const Intl6* pcm -> input frame */ 

/* InOut: SyncState* sync <-> sync struct */ 

/* */ 

void ToneDetect (SyncState *sync, const Intl6 *pcm) 
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/* UTILITY FUNCTION: UpdatePeak */ 

/* */ 

/* Description: update sync peak position */ 

/* */ 

/* In: const Int32* pos -> vector of positions */ 

/* const Int32* corr -> vector of correlation values */ 

/* Intl6 dist -> distance to be checked */ 

/* Return: Intl6 <- updated peak position */ 

/* */ 

Intl6 UpdatePeak (const Int32 *pos, const Int32 *corr, Intl6 dist) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* UTILITY FUNCTION: CheckPosPeaks */ 

/* */ 

/* Description: check positive sync peaks */ 

/* */ 

/* In: const char* caller -> text to identify PSAP or IVS */ 

/* const Int32* pCorr -> vector of correlation values */ 

/* Intl5 pi -> peak position pi */ 

/* IntlS p2 -> peak position p2 */ 

/* Intl6 ppPeaks -> number correct pos/pos distances */ 

/* Intl6 npPeaks -> number correct neg/pos distances */ 

/* Intl6 targetDelay -> target delay if sync successful */ 

/* InOut : SyncState* sync <-> sync struct */ 

/* */ 

void CheckPosPeaks (SyncState *sync, const char *caller, const Int32 *pCorr, 
Intl6 pi, Intl6 p2 , IntlS ppPeaks, Intl6 npPeaks, 
Intl6 targetDelay) 

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */ 

/* UTILITY FUNCTION: CheckNegPeaks */ 

/* */ 

/* Description: check negative sync peaks */ 

/* */ 

/* In: const char* caller -> text to identify PSAP or IVS */ 

/* const Int32* nCorr -> vector of correlation values */ 

/* Intl6 nl -> peak position nl */ 

/* Intl6 n2 -> peak position n2 */ 

/* Intl5 nnPeaks -> number correct neg/neg distances */ 

/* Intl6 npPeaks -> number correct neg/pos distances */ 

/* Intl6 targetDelay -> target delay if sync successful */ 

/* InOut : SyncState* sync <-> sync struct */ 

/* */ 

void CheckNegPeaks (SyncState *sync, const char *caller, const Int32 *nCorr, 
Intl6 nl, Intl6 n2 , Intl6 nnPeaks, Intl6 npPeaks, 
Intl6 targetDelay) 



4.4.7 Other utility functions (IVS and PSAP) 

/* UTILITY FUNCTION: SetModState */ 

/* */ 

/* Description: set the modulator state */ 

/* */ 

/* In: Intl6 modType -> type of modulator to use */ 

/* InOut: ModState* ms <-> modulator struct */ 

/* */ 

void SetModState (ModState *ms, ModType modType) 
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